Klasse ReportPresenter

java.lang.Object

com.inet.pdfc.presenter.BasePresenter

com.inet.pdfc.presenter.ReportPresenter

Alle implementierten Schnittstellen:

NamedExtension

Bekannte direkte Unterklassen:

ReportPDFPresenter

public class ReportPresenter
extends BasePresenter

Generates a statistical report of the comparison which contains diagrams of the difference types and their distribution along the pages.
An active 'reporting' plugin is required to use this filter!

Seit:

i-net PDFC 5.0

Verschachtelte Klassen - Übersicht

Von Klasse geerbte verschachtelte Klassen/Schnittstellen BasePresenter

BasePresenter.ERROR_SOURCE

Feldübersicht

Felder

Modifikator und Typ	Feld	Beschreibung
static final String	FORMAT_ODS	Export as 'Open Document Spreadsheet'
static final String	FORMAT_PDF	Export as 'Portable Document Format'
static final String	FORMAT_RTF	Export as 'Rich Text Format'
static final String	FORMAT_XLS	Export as 'Excel Spreadsheet'
static final String	FORMAT_XLSX	Export as 'Excel Spreadsheet', for version 2007 and later

Von Klasse geerbte Felder BasePresenter

LOGGER, MAX_FILENAME_LENGTH

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
ReportPresenter(boolean showDiagrams, boolean showDifferences, boolean appendSettings, String exportFormat, File target, boolean isFolder)	Creates the exporter.
ReportPresenter(boolean showDiagrams, boolean showDifferences, boolean appendSettings, String exportFormat, OutputStream target)	Creates the exporter.
ReportPresenter(boolean detailed, boolean appendSettings, String exportFormat, File target, boolean isFolder)	Creates the exporter.
ReportPresenter(boolean detailed, boolean appendSettings, String exportFormat, OutputStream target)	Creates the exporter.

Methodenübersicht

Modifikator und Typ	Methode	Beschreibung
void	detachFromModel()	Detaches this presenter from a model.
void	executeImmediately(ResultModel model)	Forces an execution of the presenter no matter the current model state. Use this method to run a presenter for an already finished model.
protected OutputStream	getExportStream()	Opens an returns an output stream for the result of the current getModel().
String	getExtensionName()	Returns the UNIQUE name of the extension.
protected ResultModel	getModel()	Returns the model this presenter is registered to
void	onClear()	Called upon comparison startup.
void	onComparisonDone()	Creates and saves a report for the registered comparison model.
void	onDataUpdate()	Called whenever the referred model receives a data chunk.
void	onError(ExceptionData error, boolean interrupted, BasePresenter.ERROR_SOURCE source)	Called in case of an error that occurred either in one of the parser threads or in the compare thread. NOTE: This method is only called for exceptions which are notified to the ResultModel.
void	onFilterChange()	Called whenever the filter conditions of the referenced model have changed.
void	onFinish()	OPTIONAL: Called in case of batch comparison at the end of all comparisons of the batch run.
void	onInit()	Called at the time the document informations have been set.
void	onProgressUpdate(float progress)	Called whenever the comparison sends a progress state.
void	setExportFormat(String exportFormat)	Sets the export format of the report.
void	setModel(ResultModel newModel)	Registers this presenter to a model.
void	setPassword(String password)	Set for the export format pdf the password
BasePresenter	spawn(boolean spawnWithParent)	Creates another presenter of the the same type as the current one.

Von Klasse geerbte Methoden BasePresenter

canInformUserOnErrors, createExportFilename, getDefaultExportName, getLastPresenterException, getParent, getPresenterExceptions, setParent

Von Klasse geerbte Methoden Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Felddetails

FORMAT_ODS

public static final String FORMAT_ODS

Export as 'Open Document Spreadsheet'

Siehe auch:

• Konstantenfeldwerte

FORMAT_PDF

public static final String FORMAT_PDF

Export as 'Portable Document Format'

Siehe auch:

• Konstantenfeldwerte

FORMAT_RTF

public static final String FORMAT_RTF

Export as 'Rich Text Format'

Siehe auch:

• Konstantenfeldwerte

FORMAT_XLS

public static final String FORMAT_XLS

Export as 'Excel Spreadsheet'

Siehe auch:

• Konstantenfeldwerte

FORMAT_XLSX

public static final String FORMAT_XLSX

Export as 'Excel Spreadsheet', for version 2007 and later

Siehe auch:

• Konstantenfeldwerte

Konstruktordetails

ReportPresenter

public ReportPresenter(boolean detailed,
 boolean appendSettings,
 String exportFormat,
 File target,
 boolean isFolder)

Creates the exporter.

Parameter:

detailed - set to true when additional the list of errors must be rendered

appendSettings - true when settings must be appended

exportFormat - defines the format of the exported report. Valid values are 'pdf', 'xls', 'xlsx', 'ods' and 'rtf'.

target - the folder or file to write the results to, will be ignored if getExportStream() is overwritten

isFolder - if the target is a folder or a file

Löst aus:

IllegalStateException - in case the presenter is used without the reporting plugin

Seit:

i-net PDFC 5.0

Siehe auch:

• FORMAT_ODS
• FORMAT_PDF
• FORMAT_RTF
• FORMAT_XLS
• FORMAT_XLSX

ReportPresenter

public ReportPresenter(boolean showDiagrams,
 boolean showDifferences,
 boolean appendSettings,
 String exportFormat,
 File target,
 boolean isFolder)

Creates the exporter.

Parameter:

showDiagrams - sets whether the overview diagrams per comparisons are supposed to be drawn

showDifferences - set to true when additional the list of errors must be rendered

appendSettings - true when settings must be appended

exportFormat - defines the format of the exported report. Valid values are 'pdf', 'xls', 'xlsx', 'ods' and 'rtf'.

target - the folder or file to write the results to, will be ignored if getExportStream() is overwritten

isFolder - if the target is a folder or a file

Löst aus:

IllegalStateException - in case the presenter is used without the reporting plugin

Seit:

i-net PDFC 5.0

Siehe auch:

• FORMAT_ODS
• FORMAT_PDF
• FORMAT_RTF
• FORMAT_XLS
• FORMAT_XLSX

ReportPresenter

public ReportPresenter(boolean detailed,
 boolean appendSettings,
 String exportFormat,
 OutputStream target)

Creates the exporter.

Parameter:

detailed - set to true when additional the list of errors must be rendered

appendSettings - true when settings must be appended

exportFormat - defines the format of the exported report. Valid values are 'pdf', 'xls', 'xlsx', 'ods' and 'rtf'.

target - the outputstream for the result

Löst aus:

IllegalStateException - in case the presenter is used without the reporting plugin

Seit:

i-net PDFC 5.0

Siehe auch:

• FORMAT_ODS
• FORMAT_PDF
• FORMAT_RTF
• FORMAT_XLS
• FORMAT_XLSX

ReportPresenter

public ReportPresenter(boolean showDiagrams,
 boolean showDifferences,
 boolean appendSettings,
 String exportFormat,
 OutputStream target)

Creates the exporter.

Parameter:

showDiagrams - sets whether the overview diagrams per comparisons are supposed to be drawn

showDifferences - set to true when additional the list of errors must be rendered

appendSettings - true when settings must be appended

exportFormat - defines the format of the exported report. Valid values are 'pdf', 'xls', 'xlsx', 'ods' and 'rtf'.

target - the outputstream for the result

Löst aus:

IllegalStateException - in case the presenter is used without the reporting plugin

Seit:

i-net PDFC 25.10

Siehe auch:

• FORMAT_ODS
• FORMAT_PDF
• FORMAT_RTF
• FORMAT_XLS
• FORMAT_XLSX

Methodendetails

getExtensionName

public String getExtensionName()

Returns the UNIQUE name of the extension. With UNIQUE referring to 'unique among all implementations of the same interface'

Gibt zurück:

the UNIQUE name of the extension

onComparisonDone

public void onComparisonDone()
                      throws Exception

Creates and saves a report for the registered comparison model.

Angegeben von:

onComparisonDone in Klasse BasePresenter

Löst aus:

Exception - on report failures or IO failures

IllegalStateException - if not model is set

Seit:

i-net PDFC 3.0

executeImmediately

public void executeImmediately(ResultModel model)
                        throws Exception

Forces an execution of the presenter no matter the current model state.
Use this method to run a presenter for an already finished model.

Setzt außer Kraft:

executeImmediately in Klasse BasePresenter

Parameter:

model - the model to be presented, if null the currently set model will be presented. This model will not be set persistently to the presenter, it will be detached at the end of this method

Löst aus:

Exception - thrown in case the processing of fails; this exception is published to the caller to allow a feedback to the user

getModel

protected ResultModel getModel()

Returns the model this presenter is registered to

Setzt außer Kraft:

getModel in Klasse BasePresenter

Gibt zurück:

the model, is null until a comparison was started where this Presenter was added to.

detachFromModel

public void detachFromModel()

Detaches this presenter from a model. Call this method if the presenter should no longer generate output for the referenced model.

Setzt außer Kraft:

detachFromModel in Klasse BasePresenter

onClear

public void onClear()
             throws Exception

Called upon comparison startup. This does not imply which data is available to the model, but most likely the model has been cleared at this point.

Setzt außer Kraft:

onClear in Klasse BasePresenter

Löst aus:

Exception - thrown in case the processing of the clear step fails

onDataUpdate

public void onDataUpdate()
                  throws Exception

Called whenever the referred model receives a data chunk. This does not imply that any differences are available yet as it is called as well for no-difference areas.

Setzt außer Kraft:

onDataUpdate in Klasse BasePresenter

Löst aus:

Exception - thrown in case the processing of the update step fails

onError

public void onError(ExceptionData error,
 boolean interrupted,
 BasePresenter.ERROR_SOURCE source)

Called in case of an error that occurred either in one of the parser threads or in the compare thread.
NOTE: This method is only called for exceptions which are notified to the ResultModel.

Setzt außer Kraft:

onError in Klasse BasePresenter

Parameter:

error - the exception

interrupted - indicates whether the comparison was interrupted due to this exception. If true there will be no further calls (e.g. onComparisonDone)

source - the source module of the exception.

onFilterChange

public void onFilterChange()
                    throws Exception

Called whenever the filter conditions of the referenced model have changed. This method is not called automatically during a comparison but rather a reaction to a configuration change that can be applied to the model.

Setzt außer Kraft:

onFilterChange in Klasse BasePresenter

Löst aus:

Exception - thrown in case the processing of the filter update fails

onFinish

public void onFinish()

OPTIONAL: Called in case of batch comparison at the end of all comparisons of the batch run. This method cannot be triggered by an event of any referenced result model. It's sole purpose is to serve as a callback for the PDFComparer.batchCompare(java.io.File, java.io.File) method.
NOTE: This method only called once per batch compare and only for the root presenter, never for spawned ones.

Setzt außer Kraft:

onFinish in Klasse BasePresenter

onInit

public void onInit()
            throws Exception

Called at the time the document informations have been set.

Setzt außer Kraft:

onInit in Klasse BasePresenter

Löst aus:

Exception - thrown in case the processing of the init step fails

onProgressUpdate

public void onProgressUpdate(float progress)

Called whenever the comparison sends a progress state. In some rare cases the same progress value may be sent multiple times.

Setzt außer Kraft:

onProgressUpdate in Klasse BasePresenter

Parameter:

progress - the progress in percent, a value between 0 and 100, bounds included.

setModel

public void setModel(ResultModel newModel)

Registers this presenter to a model. If it already was registered to a model, the old model will be detached first.

Setzt außer Kraft:

setModel in Klasse BasePresenter

Parameter:

newModel - the new

spawn

public BasePresenter spawn(boolean spawnWithParent)

Creates another presenter of the the same type as the current one. The spawned presenter may either have the same settings as the current one or it may be a child of the current one.

Setzt außer Kraft:

spawn in Klasse BasePresenter

Parameter:

spawnWithParent - if true, the presenter is allowed to keep a reference to it's parent to create a summary on onFinish()

Gibt zurück:

a new presenter for the same batch comparison run as the current one

getExportStream

protected OutputStream getExportStream()
                                throws IOException

Opens an returns an output stream for the result of the current getModel(). The caller of this method will close the stream itself!

Gibt zurück:

the stream to write the current result to

Löst aus:

IOException - thrown in case the stream could not be created

Seit:

i-net PDFC 3.0

setExportFormat

public void setExportFormat(String exportFormat)

Sets the export format of the report. Valid values are 'pdf', 'xls', 'xlsx', 'ods' and 'rtf'

Parameter:

exportFormat - the export format to be set

Seit:

i-net PDFC 4.3

setPassword

public void setPassword(String password)

Set for the export format pdf the password

Parameter:

password - the password (currently only for pdf)

Seit:

i-net PDFC 21.4